home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Programming Languages Suite
/
ProgramD2.iso
/
Borland
/
Borland C++ For TASM
/
TSM_INST.TXT
< prev
next >
Wrap
Text File
|
1996-02-21
|
25KB
|
640 lines
/*************************************************************************/
TSM_INST.TXT
TURBO ASSEMBLER 5.0
This file contains details on how to install the TASM 5.0 package.
--------------------------------------------------------------------
TABLE OF CONTENTS
SECTION 1 System Requirements - Full Installation
SECTION 2 Installing TASM 5.0
A) Pre-Installation Notes
1) Backup Disks
2) Disk Compressions
4) Network Installation
B) Where to install
C) Installation Instructions
D) After Installation
SECTION 3 Minimum and Selected Installation Options
SECTION 4 Troubleshooting - Install Issues
A) Data Integrity or Bad Section Errors
B) Disk Full or Insufficient Disk Space
Errors
C) GP Fault or Unhandled Exception Errors
SECTION 5 Troubleshooting - Run Time Problems
A) Out of Memory Errors
B) GP Fault or Unhandled Exception Errors
C) Turbo Debugger for Windows
SECTION 6 Icons in the TASM Group Window
A) Creating a Program Group Window for TASM
B) List of Icons and Executable Files
SECTION 7 Using TASM from Windows
SECTION 8 How to Get A Technical Information Document
A) From TechFax
B) From Bulletin Boards
SECTION 9 Boot Clean
--------------------------------------------------------------------
SEARCH INSTRUCTIONS: To go directly to a specific
section, use your editor's search utility and search on
"SECTION -#-" replacing the # with the appropriate section
number.
SECTION -1- SYSTEM REQUIREMENTS
================================
Before installing TASM please review the minimum
system requirements listed below:
System requirements for a generic full installation
(both 16- and 32-bit installation):
8 MB system memory (req. to run Win32)
Intel 386 or higher
DOS 5.01 or later
Windows 3.1 or later (to access Turbo Assembler help file)
Windows '95 or Windows NT (for targeting those environments)
Approximately 10 MB hard disk space
3.5" High Density Disk Drive
Generally, you should use a host environment with a capability that is
equal to or greater than capability of the system you plan to target.
For example, if you are building 32-bit applications for Windows 95 or
Windows NT, you should use TD32 in a Win32 environment.
NOTE: On a compressed hard disk the installation process
might need additional hard disk space. If you are using
a disk compression utility, refer to Section 2, part A.
SECTION -2- INSTALLING TASM 5.0
================================
A) Pre-Installation Notes
-------------------------
1) Backup Disks
If you wish to make backup copies of your original disks
use the DOS DISKCOPY command. You must use the same disk
size and media (density) when you make your backup set of
disks. Attempting to copy from 3.5" to 5.25" will cause
the install program to fail. If you have a bad disk
contact Borland's Disk Replacement line at (800) 621-3132.
2) Disk Compression
If you are using a disk compression utility (such as
Stacker[tm], DoubleSpace[tm], XtraDrive[tm],
SuperStor[tm], etc.) the estimated available hard disk
space reported might not be sufficient to install the
product. During installation, TASM 5.0 copies compressed
files onto your hard disk. Disk compression utilities
report available hard disk space assuming that the files
copied onto the disk can be compressed. Since the files
that are copied by the installation program are already
compressed, the disk compression utility cannot compress
them any further. To solve this, you might need to free
additional hard disk space for the installation.
3) Network Installation
If you are installing TASM 5.0 on a network, you may wish
to consult Technical Information Document number 1738. For
information on how to receive this document, refer to
Section 10.
B) Where to Install:
--------------------
This product is designed to be used as a standalone product or in
conjunction with Delphi 2.0 or Borland C++ 5.0. It can also be used
with Borland/Turbo C++ 4.x, Borland Pascal 7 or Delphi 1.0. If you are
using Turbo Assembler 5.0 in conjunction with any of these Borland
compilers, you can install Turbo Assembler atop the same directory
heirarchy as your other Borland Tools.
If you use Turbo Assembler 5.0 with any other Borland development tools or
versions, then it is best to install Turbo Assembler to a unique
directory, such as c:\tasm. Both tool sets should be referenced in your
dos path with the most recent version being first in the path. For custom
configuration requirements, please contact Technical Support.
C) Installation Instructions:
-----------------------------
1. Boot Clean
It is highly recommended that you boot clean before
installing TASM 5.0. Booting your system with a clean
configuration will eliminate any potential software
conflicts that might arise during installation. Refer to
Section 10 for instructions on how to boot clean.
2. Insert the TASM 5.0 installation disk into drive A or B.
3. From the DOS prompt type A:INSTALL (or B:INSTALL)
and press <ENTER>. Do not install from a Windows DOS prompt.
4. Select installation options from the install menu. See
Section 3 for more details on the installation instructions.
5. Choose START INSTALLATION to begin installation. If problems
occur during installation, note any error messages and refer to
Section 5.
D) After Installation:
----------------------
1. After the install has completed, the README file appears.
The README file contains important information about
configuring and using TASM 5.0, including late changes
which might have occurred after the manuals were printed.
2. Modify your CONFIG.SYS so that files and buffers are set
to at least 40. For example:
FILES=40
BUFFERS=40
Also modify your AUTOEXEC.BAT file by adding to your path
statement the TASM 5.0 bin directory. For example:
PATH C:\TASM\BIN;C:\;C:\DOS;C:\WINDOWS
3. If you are installing Delphi 1.0, or Borland C++ 4.x AFTER
Turbo Assembler 5.0 has been installed, you will have to manually
change the system settings that allow these products to coexist:
In your system.ini file, check your [386Enh] section for multiple
entries for the device TDDEBUG.386. Remove duplicate entries of
TDDEBUG.386 so that only the version from this product is loaded.
On disk, you may also want to rename or remove the BP7 or BC4.x
versions of TDDEBUG.386 and TDWINTH.DLL to avoid their accidental
loading. You must restart Windows after making changes to system.ini.
4. Changes to SYSTEM.INI file:
Presuming you have installed Turbo Assembler and Tools to "c:\tasm",
The install program makes these changes to the SYSTEM.INI file:
1) Adds "device=c:\tasm\bin\windpmi.386" to support our 32-bit tools.
2) Adds "device=c:\tasm\bin\tddebug.386" to support our debugger.
5. Configuring the Windows NT command prompt:
To run 16-bit protected-mode programs (tlink) under an NT command
prompt you need to add the following line to CONFIG.NT:
ntcmdprompt
Under the default NT command-line prompt, DOS COMMAND.COM is run
after returning from a TSR (such as RTM.EXE which bcc and tlink load).
Adding the above line will cause the original NT CMD.EXE to be run.
SECTION -3- MINIMUM AND SELECTIVE INSTALLATION OPTIONS
=======================================================
This section outlines the minimum and selective install
options available for TASM 5.0.
There are some files that are common to more than one option.
For example, MAKE.EXE will be installed if either the 16-bit or
the 32-bit command line tools are installed. { Common to 16-bit
and 32-bit tools is [2360K] of files ; Common to the TDWIN and
TDWIN32 options is [504K] of files } Those common files are
included in all the following estimates.
16-bit command line tools [3085K]
Install the 16-bit tools (TASM, TLINK).
(Minimum installation option)
32-bit command line tools [3163K]
Install the 32-bit tools (TASM32, TLINK32).
Turbo Debugger for DOS [1041K]
Install Turbo Debugger for DOS.
(Minimum installation option)
Turbo Debugger for Windows [1533K]
Install Turbo Debugger for Windows and associated Debugger
tools (TDWINI setup, wremote).
Turbo Debugger for Win32 [1502K]
Install Turbo Debugger for Win32 programs.
Examples [580K]
Install Borland TASM examples.
Documentation Files [6K]
Install documentation files.
SECTION -4- TROUBLESHOOTING - INSTALL PROBLEMS
===============================================
This section explains a few common errors encountered during
installation. System configuration and software conflicts
might cause the installation process to fail. If the
installation fails, follow the instructions in Section 10
on how to boot clean. This will eliminate any possible
software conflicts. If booting clean doesn't solve the
problem, or you encounter a problem not mentioned here,
contact Borland Technical Support.
With any of the following installation errors there are
several common steps that can be taken to enable the
installation to complete.
- Make sure your system meets the minimum requirements.
Refer to Section 1 for a list of the minimum
installation requirements.
- Boot your system with a clean configuration. Refer to
Section 10 for instructions on how to boot clean.
- Install the product from your local hard drive. Sometimes
a timing error between the hard drive and a disk drive will
generate an error from the TASM install. Installing from
the hard drive can solve this problem. (Especially in
conjunction with a clean boot)
1) Copy the contents of all the diskettes to a temporary
directory on your hard drive. The following is an example
of the command:
COPY *.* c:\temp
If you should get an error during the copying process see
below for information on how to get a replacement disk set.
2) Change directories to the temp directory and then type
install. For example:
CD c:\temp
INSTALL
A) Data Integrity or Bad Sector on Disk Errors
----------------------------------------------
If you receive either one of these error messages, you
need to get a replacement disk set. Contact Borland's
Disk Replacement Line at (800-621-3132).
B) Disk Full or Insufficient Disk Space Errors
----------------------------------------------
You could also get this error if there is insufficient
hard disk space available to install TASM 5.0.
- If you are using disk compression read Section -2-
part A) on reported available disk space when using
disk compression.
C) GP Fault/Unhandled Exception
-------------------------------
GP Fault or Unhandled Exception errors can occur for a
variety of reasons. Possible reasons for these errors are
explained in Technical Information Document number 649.
Refer to Section 9 for instructions on how to obtain
this document.
- Turn off Disk Caching and Video/Shadow RAM in CMOS.
Refer to the documentation for your computer.
SECTION -5- TROUBLESHOOTING - RUN TIME PROBLEMS
================================================
This section describes common errors encountered when
trying to use tools included in TASM 5.0. System configuration
and software conflicts might cause one of the tools to fail.
If a tool fails, you should boot your system clean to eliminate
any possible software conflicts. Refer to Section 10 for
instructions on how to boot clean. If booting clean does not
solve the problem or you encounter a problem not mentioned here,
contact Borland Technical Support.
A) Out of Memory
----------------
If you are using command-line tools and are getting
"Out of Memory" errors you might have exhausted your
extended (or XMS) memory pool. This is especially true if
you only have 2MB available extended RAM and do not have
a memory manager that provides virtual memory. If you are
experiencing this, please consult the TASM readme file that
can be found in the TASM directory, under the section General,
Out of Memory. This information can also be found in the
Technical Information Document number 1737. For information
on how to receive this document, refer to Section 9.
B) GP Fault/Unhandled Exception/System Hang
-------------------------------------------
GP Fault or Unhandled Exception errors can occur for a
variety of reasons including: not enough memory
available, not enough hard disk space available,
conflicts with optimizations set in the CMOS, and
software conflicts. Technical Information Document
numbers 649 and 1328 address these issues. Refer to
Section 9 for information on how to obtain these files.
C) Turbo Debugger for Windows
-----------------------------
If you experience any strange behavior from the Turbo
Debugger, such as a garbled screen or a system hang upon
execution or exit:
1) Make sure that you have the latest Windows drivers
for your video card.
2) Run TDWINI and test a different DLL to resolve a
possible compatibility problem with your specific
card.
3) Check README.TXT for additional information.
4) If you are still experiencing difficulties your
problem might not be related to the video mode. At
this point contact Borland Technical Support via
phone or online help. Refer to Section 10 for more
information about online options and procedures.
SECTION -6- ICONS IN THE TASM GROUP WINDOW
===========================================
A) Creating a Program Group Window for TASM 5.0.
------------------------------------------------
If the Borland C++ Program Group Window didn't appear
after installation you can create one by choosing one of
the following options:
- Generate icons by running the groups.exe:
From within Windows, choose File|Run, and type:
c:\windows\groups.exe groups.b$$
If nothing appears to happen, it is possible that the
data file (groups.b$$) was not created properly.
- Manually creating the icons. Load Windows, choose
File|New|Program Group, and click on OK. Type the
name you want for the program group window in the
"Description:" text box, such as Borland TASM 5.0. Leave
"Group File" line blank. Click OK. A new Window appears.
Choose File|New|Program Item to create icons for the
Windows programs and click OK. Select one of the
Windows executable programs to create an icon for, such
as TDW.EXE (you can also use the Browse button). Type
the name of that executable program in the Description
text box. Type the full path name to the executable in
the Command Line text box. Typing a path name for the
working directory is optional. The default is the
WINDOWS directory. Click OK. The icon appears in
the active program group window. Repeat these steps
for executable program you want to use.
B) List of Icons and Executable Files
-------------------------------------
The following table contains a list of executable files that
each icon calls, as well as the name of the icon for that
executable, if there is one:
TASM.HLP=F:\TASM\BIN, Tasm Reference, HELP.ICO
TDW.EXE=F:\TASM\BIN, Turbo Debugger for Windows, TDW.ICO
TDWINST.EXE=F:\TASM\BIN, TDW Configuration, TDWINST.ICO
WREMOTE.EXE=F:\TASM\BIN, Remote Debugging
WRSETUP.EXE=F:\TASM\BIN, Remote Setup
TD.PIF=F:\TASM\BIN, Turbo Debugger for DOS, TDDOS.ICO
TDINST.EXE=F:\TASM\BIN, TD Configuration, TDOSINST.ICO
TD32.EXE=F:\TASM\BIN, Turbo Debugger for Win32, TD32.ICO
TD32INST.EXE=F:\TASM\BIN, TD32 Configuration, TD32INST.ICO
TDWINI.EXE=F:\TASM\BIN, TD Video Configuration
SECTION -7- USING TASM FROM WINDOWS
====================================
The TASM installation creates a TASM 5.0 group in the Windows
Program Manager. However, the installation program does not
create Windows PIF files to run any of the command line tools.
TASM.EXE and all other 16-bit executable tools can be run through
a regular Windows DOS box.
To run TASM32 from a Windows DOS box, you need to use an icon
created with a PIF file. You can use the PIF file B32TOOLS.PIF
(located in the TASM\BIN directory) to run the 32-bit tools
from a Windows DOS box. This PIF file references COMMAND.COM.
When you double click the icon, a DOS box activates, and you
can run TASM32.EXE and TLINK32.EXE from it.
SECTION -8- HOW TO GET A TECHNICAL INFORMATION DOCUMENT
========================================================
Technical Information Documents contain tips, techniques,
and enhanced information on using Borland development tools,
and information on commonly asked programming questions.
Such documents often include programming examples. These
documents can be accessed via modem or fax. Technical
files which contain binary modules, such as patches for
released Borland products, are normally available only from
those services that can be accessed by modem. Documents can
be accessed from the following sources:
A) Fax the document from Borland's TechFax Service
--------------------------------------------------
Call (800) 822-4269 from a touch-tone phone. When
prompted, enter your FAX number, then enter the document
number you want to receive. The document will be faxed to
you shortly.
Here is a list of common Technical Information Documents:
* 3 General Catalog of All Documents Available
* 649 General Protection Faults
* 1171 Problem Report Form
* 1010 Installing and Configuring BC++
* 806 Network Installations
* 738 Memory Corruption
* 1561 Clean Boot
B) Download the document from
-----------------------------
-The Borland Download Bulletin Board Service (DLBBS)
(408) 431-5096, protocol 8N1
-The Borland Automated Online Service (OAS)
(408) 431-5250, protocol 8N1
-The Borland-supported FTP site on Internet
ftp.cica.indiana.edu, IP address [129.79.20.27]
-Borland-supported forums on CompuServe, Genie, BIX.
For CIS type:
go BCPPWIN
or
go BCPPDOS
and choose library 2
For BIX type: join Borland
For GENIE type: Borland
Below are steps to download a Technical Information
Document from the Borland DLBBS.
For proper display, your communication software should
provide ANSI terminal support. Most packages provide
VT-100 terminal emulation, which is fine for the DLBBS.
If you're using a Windows based package, select a screen
font (such as: Terminal) that includes extended ASCII
characters.
Once connected, you'll be prompted to enter your first
and last name and a password. If you haven't used the
service before, you'll be asked to verify your name and
then answer a few questions. The menu-driven system
guides you through the various product and file
areas. You'll always receive a list of options when you
are prompted to make any choice.
MANEUVERING THE MAIN MENU
- - - - - - - - - - - - -
First join the C++ Conference. The Main Menu shows the
product whose files you can access. At the Main menu,
type "F" to select the Files menu.
DOWNLOADING FILES
- - - - - - - - -
Once you know the name of the file you want to download,
type "D" for download at the File menu. When prompted,
type the full name of the file or files. All Technical
Information Documents have the form "TI#.ZIP". Replace
the # with the appropriate document number. For example,
to download Technical Information Document number 649,
the full name of the file is TI649.ZIP. If you do not
know the protocol or download keys to press, refer to
your telecommunications manual.
WORKING WITH DOWNLOADED FILES
- - - - - - - - - - - - - - -
Most of the files on the Download BBS are stored and
transferred in an archived (compressed) format and need
to be unarchived before they can be used. If you don't
have the unarchiving utility PKUNZIP v.204G or newer,
download PKZ204G.EXE from the DLBBS and execute it.
You'll receive PKUNZIP and PKZIP utilities. To unarchive
the file, type the name of an unarchive utility
(UNPACK, UNZIP or PKUNZIP) and then the name of the
archived file. For example:
PKUNZIP TI649.ZIP
SECTION -9- BOOT CLEAN
========================
This section describes the process of "booting clean" on
IBM PC's and compatible computers with DOS and/or windows.
This document assumes you have MS-DOS version 5.00 or higher.
"Booting Clean" is the process of booting without loading
device drivers and TSRs. Device drivers such as mouse
drivers, network drivers, TSRs, etc. can cause memory
conflicts.
These device drivers and TSRs are usually loaded in two
files (AUTOEXEC.BAT and CONFIG.SYS typically located on
the root directory of your hard disk). The safest
method of booting clean is to create a "bootable" floppy
disk in drive A:. See the "Making a Boot Disk" section
below.
If you are using a program that runs under Microsoft
Windows, then you might need to make changes to some Windows
configuration files in order to ensure a "clean system
configuration" under Windows. The two files you will need
to examine are WIN.INI and SYSTEM.INI. These files are
located in the WINDOWS subdirectory on your hard disk. The
changes that you will need to make to these files (if any)
are outlined below.
Making a Boot Disk
- - - - - - - - - -
In order to make a bootable floppy disk, follow the
instructions below. NOTE: These instructions assume that
your hard disk is C: and your DOS and WINDOWS subdirectories
appear on this disk. (Most cases):
1) Place a blank disk in drive A:
2) type format a: /s (format the disk)
At this point you now have a bootable floppy disk. Using
EDIT, ensure your AUTOEXEC.BAT and CONFIG.SYS look like
one of the configuration choices below.
Your "clean" system configuration should be exactly like
one of the choices below except replace "<Insert REQUIRED
drivers here>" with any required drivers. The ONLY
required drivers are, for example, disk compression and/or
hard disk access drivers. This does not include mouse
drivers and disk caching utilities such as SmartDrive.
Clean Configuration DOS 5.0 and DOS 6.x running Windows
-------------------------------------------------------
1) Insert your "bootable floppy" in drive A.
2) Type "EDIT A:\CONFIG.SYS"
3) Type in the following:
<Insert REQUIRED drivers here>
DEVICE=C:\DOS\HIMEM.SYS
FILES=40
BUFFERS=40
4) Exit the editor (Alt-F, then X, then Y).
5) Type "EDIT A:\AUTOEXEC.BAT"
6) Type in the following:
<Insert REQUIRED drivers here>
PATH=C:\WINDOWS;C:\DOS;C:\BC4\BIN
PROMPT $P$G
7) Exit the editor (Alt-F, then X, then Y).
8) Type "CD \WINDOWS:
9) Type "COPY WIN.INI WIN.BAK"
10) Type "COPY SYSTEM.INI SYSTEM.BAK"
11) Type "EDIT WIN.INI"
12) Make sure that the "load=" and "run=" lines in your
WIN.INI file match the following lines:
[windows]
spooler=yes
load=
run=
Beep=yes
13) Exit the editor (Alt-F, then X, then Y).
14) Type "EDIT system.ini"
15) Ensure that your "shell=" line in your SYSTEM.INI file
matches the following:
[boot]
shell=progman.exe
16) Exit the editor (Alt-F, then X, then Y).
17) Make sure your "Bootable floppy" is in drive A: and
reboot your computer.
/**************************** END OF FILE ********************************/